XIQS Create Rack

From IQsimWiki

Jump to: navigation, search

XIQS Create Rack - Sim Rack Management

Description
createXIQSRack ( String name , String dns , Long tcpport , String dns2 , Long tcpport2 [, Long id_partition ] )
Create a new IRON Sim Rack object. The new created object Id is returned.
Parameters

String name

Rack Name

String dns

Rack DNS

Long tcpport

Rack port. If two iQSIM Arrays have the same public IP address, they will then need to be addressed using different ports.

String dns2

Rack DNS2

Long tcpport2

Rack port2. If two iQSIM Arrays have the same public IP address, they will then need to be addressed using different ports.

[ Long id_partition ]

Partition Id
Return Values
Structure
Long id - New IRON Sim Rack Id

Error Data structure ( Error Management )

Possible failure code returns
*ERR_OBJ_NOT_FOUND (404) ERR_MSG_OBJ_NOT_OWNED
*ERR_OBJECT_EXISTS (451) ERR_MSG_RCK_NAME_FOUND or ERR_MSG_RCK_IP_FOUND
*ERR_SRV_INTERNAL (500) ERR_MSG_NO_DB
See Also

getXIQSRackList

updateXIQSRack

deleteXIQSRack

Example

[REQUEST]
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<command tid="5e1dce61-0df2-48ac-ba3d-3f0fe4262b75" name="createXIQSRack">
  <param type="string">TestSA</param>
  <param type="string">192.168.1.51</param>
  <param type="long">51503</param>
  <param type="string">192.168.1.2</param>
  <param type="long">51503</param>
  <param type="long">2</param>
</command>

[ANSWER (OK)]
<?xml version="1.0" encoding="ISO-8859-1"?>
<event type="return" tid="5e1dce61-0df2-48ac-ba3d-3f0fe4262b75">
  <meta-data>
    <meta-value>
      <name>id</name>
      <pos>1</pos>
    </meta-value>
  </meta-data>
  <param type="long">2</param>
</event>

[ANSWER (Error)]
<?xml version="1.0" encoding="ISO-8859-1"?>
<event type="error">
  <meta-data>
    <meta-value>
      <name>err_code</name>
      <pos>1</pos>
    </meta-value>
    <meta-value>
      <name>err_desc</name>
      <pos>2</pos>
    </meta-value>
  </meta-data>
  <param type="integer">451</param>
  <param type="string"> err.rack.name.exist(TestSA)</param>
</event>

Personal tools
Namespaces
Variants
Views
Actions
Navigation
XIQS XML Protocol
XIQS Framework Libraries
XIQS Command List